URIidevelopment
Class URIPolicies

java.lang.Object
  URIidevelopment.URIPolicies

public class URIPolicies
extends java.lang.Object

Constructor Summary

URIPolicies()

Method Summary

java.lang.String	appellationURI(java.lang.String className, java.lang.String subjUri, java.lang.String appellation) returns a URI for a specific appellation about an entity determined by the subject URI given
java.lang.String	createLiteral(java.lang.String className, java.lang.String type, java.lang.String note) returns a Literal.
java.lang.String	dimensionURI(java.lang.String className, java.lang.String subjUri, java.lang.String dimensions) returns a URI for a specific dimensions about an entity determined by the subject URI given
java.lang.String	uriConceptual(java.lang.String className, java.lang.String thing) returns a URI for Conceptual Things
java.lang.String	uriEvents(java.lang.String className, java.lang.String authority, java.lang.String eventID, java.lang.String subjUri) returns a URI for an Event based either on an already registered identifier for it, or on the type of the event determined by the className - if it is unique for the subject it is referred to(Birth, Death, Creation, etc.), or a UUID otherwise
java.lang.String	uriForActors(java.lang.String className, java.lang.String authority, java.lang.String id, java.lang.String name, java.lang.String birthDate) returns a URI for Actor depending on the available information about him (an already registered identifier or his name combined with his vital Dates), or a UUID if there is no such information available.
java.lang.String	uriForPhysicalObjects(java.lang.String className, java.lang.String nameOfMuseum, java.lang.String entry) returns a URI for the mainly described object.
java.lang.String	uriForPlaces(java.lang.String className, java.lang.String placeName, java.lang.String authority, java.lang.String placeID, java.util.ArrayList<java.lang.String> coordinates, java.util.ArrayList<java.lang.String> spaces) returns a uri for a specific place according to the available information about the geographical spaces or coordinates it belongs.
java.lang.String	uriPhysThing(java.lang.String className, java.lang.String thing) returns a URI for Physical Things
java.lang.String	uriTimeSpan(java.lang.String className, java.lang.String timespan) returns a URI for a TimeSpan defined by the argument timespan
java.lang.String	uriType(java.lang.String className, java.lang.String type) returns a URI for a specific Type
java.lang.String	uuid(java.lang.String className) returns a random UUID

Methods inherited from class java.lang.Object

equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

URIPolicies

public URIPolicies()

Method Detail

uriForPhysicalObjects

public java.lang.String uriForPhysicalObjects(java.lang.String className,
                                              java.lang.String nameOfMuseum,
                                              java.lang.String entry)

returns a URI for the mainly described object.

Parameters:

className - the name of the corresponding CIDOC class

nameOfMuseum - the name of the organization keeping the object.

entry - the id given to the object by the organization

Returns:

the URI of the form "urn:iso21127:(Main_Object)nameOfMuseum:entry" (e.g. "urn:iso21127:(Main_Object)Germanic_National_Museum,_Graphical_Collection_(Nuremberg):H_3672") if nameOFMuseum and entry is not null, or a uuid otherwise.

uriForPlaces

public java.lang.String uriForPlaces(java.lang.String className,
                                     java.lang.String placeName,
                                     java.lang.String authority,
                                     java.lang.String placeID,
                                     java.util.ArrayList<java.lang.String> coordinates,
                                     java.util.ArrayList<java.lang.String> spaces)

returns a uri for a specific place according to the available information about the geographical spaces or coordinates it belongs.

Parameters:

className - the name of the corresponding CIDOC class

placeName - the name of the Place

authority - the authority that has assigned an id to this place

placeID - the id given to this place by the authority

coordinates - the geographical coordinates of the current place

spaces - the geographical spaces the place belongs

Returns:

a URI in the form "urn:iso21127:(Place)Authority-id" (e.g. "urn:iso21127:(Place)TGN:7001393") if the authority and placeID are not null, a URI in the form "urn:iso21127:(Place)longitude_latidute" (e.g."urn:iso21127:(Place)37°58'N_23°46'E") if the structure coordinates is not null a URI in the form "urn:iso21127:(Place)inhabitedPlace-region-nation-continent"(e.g. "urn:iso21127:(Place)Athens-Perifereia_Protevousis-Greece-Europe")if the structure spaces is not null or a uuid otherwise

uriForActors

public java.lang.String uriForActors(java.lang.String className,
                                     java.lang.String authority,
                                     java.lang.String id,
                                     java.lang.String name,
                                     java.lang.String birthDate)

returns a URI for Actor depending on the available information about him (an already registered identifier or his name combined with his vital Dates), or a UUID if there is no such information available.

Parameters:

className - the name of the corresponding CIDOC class

authority - if not null, it represents an authority that has registered a specific identifier to the current Actor

id - the identifier registered to the Actor

name - the Name of the Actor

birthDate - the date Actor was born

Returns:

a URI of the form "urn:iso21127:(Actor)authority:id" (e.g. "urn:iso21127:(Actor)DISKUS-KUE-Datei:10153461")if authority and id are not empty, a URI of the form "urn:iso21127:(Actor)name,b.birthDate" (e.g. urn:iso21127:(Actor)Camerlohr,_Joseph_von,b.1820) if the name and the vitalDates are not empty, or a UUID otherwise

uriPhysThing

public java.lang.String uriPhysThing(java.lang.String className,
                                     java.lang.String thing)

returns a URI for Physical Things

Parameters:

className - the name of the corresponding CIDOC class

thing - the name of the thing

Returns:

a URI of the form "urn:iso21127:(Thing-ClassName)thing" (e.g. "urn:iso21127:(Thing-Document)obj_00120252")

uriConceptual

public java.lang.String uriConceptual(java.lang.String className,
                                      java.lang.String thing)

returns a URI for Conceptual Things

Parameters:

className - the name of the corresponding CIDOC class

thing - the name of the thing

Returns:

a URI of the form "urn:iso21127:(Conceptual-ClassName)thing" (e.g. "urn:iso21127:(Conceptual-Right)Copyright")

uriType

public java.lang.String uriType(java.lang.String className,
                                java.lang.String type)

returns a URI for a specific Type

Parameters:

className - the name of the corresponding CIDOC class

type - the type

Returns:

a URI of the form "urn:iso21127:(Type-ClassName)type" (e.g."urn:iso21127:(Type)Paper")

appellationURI

public java.lang.String appellationURI(java.lang.String className,
                                       java.lang.String subjUri,
                                       java.lang.String appellation)

returns a URI for a specific appellation about an entity determined by the subject URI given

Parameters:

className - the name of the corresponding CIDOC class

subjUri - the URI of the subject to which the appellation corresponds

appellation - the appellation of the subject

Returns:

a URI if the form: "urn:iso21127:(Appellation-ClassName)@subjUri@appellation" (e.g. "urn:iso21127:(Appellation-Actor_Appellation)@urn:iso21127:(Actor)DISKUS-KUE-Datei:10153461@Camerlohr,_Joseph_von")

dimensionURI

public java.lang.String dimensionURI(java.lang.String className,
                                     java.lang.String subjUri,
                                     java.lang.String dimensions)

returns a URI for a specific dimensions about an entity determined by the subject URI given

Parameters:

className - the name of the corresponding CIDOC class

subjUri - the URI of the subject to which the dimensions correspond

dimensions - the dimensions of the subject

Returns:

a URI of the form: "urn:iso21127:(Dimensions)@subjUri@dimensions" (e.g. "urn:iso21127:(Dimensions)@urn:iso21127:(Main_Object)Germanic_National_Museum,_Graphical_Collection_(Nuremberg):H_3672@44,3x35,4_cm)

uriTimeSpan

public java.lang.String uriTimeSpan(java.lang.String className,
                                    java.lang.String timespan)

returns a URI for a TimeSpan defined by the argument timespan

Parameters:

className - the name of the corresponding CIDOC class

timespan - the period of time

Returns:

a URI of the form: "urn:iso21127:(TimeSpan)timespan" (e.g. "urn:iso21127:(TimeSpan)1871")

uriEvents

public java.lang.String uriEvents(java.lang.String className,
                                  java.lang.String authority,
                                  java.lang.String eventID,
                                  java.lang.String subjUri)

returns a URI for an Event based either on an already registered identifier for it, or on the type of the event determined by the className - if it is unique for the subject it is referred to(Birth, Death, Creation, etc.), or a UUID otherwise

Parameters:

className - the name of the corresponding CIDOC class

authority - the qualified authority for the event identifier

eventID - the event identifier

subjUri - the URI of the subject to which the event corresponds

Returns:

a uri of the form "urn:iso21127:(Event)Authority-eventID" (e.g. "urn:iso21127:(Event)KB:1334")if an identifier already exists, one of the form "urn:iso21127:(Event)@subjUri@className" (e.g. "urn:iso21127:(Event)@urn:iso21127:(Actor)DISKUS-KUE-Datei:10153461@Birth) if the className is one of the Birth, Death, Creation, etc. in other words if the event is unique for the referred subject, or a UUID otherwise

uuid

public java.lang.String uuid(java.lang.String className)

returns a random UUID

Parameters:

className - the name of the corresponding CIDOC class

Returns:

a random UUID e.g. "urn:uuid:9a9bccf9-e530-4ab7-a51b-5ac9ce1067e0"

createLiteral

public java.lang.String createLiteral(java.lang.String className,
                                      java.lang.String type,
                                      java.lang.String note)

returns a Literal. That rule refers to any information being represented as a String. This is not a urn form.

Parameters:

className - the name of the corresponding CIDOC class

type - the type of information described

note - the String representation

Returns:

a URI of the form "literal:type:note" (e.g. "literal:recordType:Item")